home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINWORDS / SETUPPRN.ZIP / SETUPPRN.TXT < prev   
Text File  |  1993-06-18  |  13KB  |  315 lines
  1. (c) Copyright MG Software, P.O.Box 939, Lake Shore, MD 21122
  2.  
  3.             SETUPPRN.EXE
  4.  
  5. INTRODUCTION
  6. ------------
  7. MG Software developed this program to solve a report printing 
  8. problem many computer users encounter.
  9.  
  10. THE PROBLEM: Some programs do not let users change margins or 
  11. select fonts and other printer features when printing a report, 
  12. EVEN when their printer supports such commands.
  13.  
  14. SetupPRN solves this problem for most programs by providing a 
  15. simple user interface which sends commands to printers. It works 
  16. with any printer properly connected to an MS-DOS based computer 
  17. running DOS 3.x or Windows 3.x.
  18.  
  19. The READ.ME file describes installation.
  20.  
  21.  
  22. METHOD OF OPERATION
  23. -------------------
  24. To setup a printer you must send commands to the printer. The 
  25. commands take the form of strings of printable and non printing 
  26. ASCII characters. These commands are sometimes called escape 
  27. sequences and are typically listed in a table or appendix in your 
  28. printer manual. Frequently such tables include decimal, hexadecimal 
  29. and the ASCII equivalent of each command.
  30.  
  31. SetupPRN has a text box in the center of the screen labeled DECIMAL 
  32. PRINTER COMMAND. You may type decimal values between 0 and 255 into 
  33. this text box and edit them with your backspace keys, cursor, home
  34. key, end key and mouse.
  35.  
  36. When you press the EXECUTE button, all of the text in the DECIMAL 
  37. PRINTER COMMAND text box is converted to ASCII characters and sent 
  38. to your printer.
  39.  
  40. A list box holding printer functions and several other buttons 
  41. are available to make your work easier then just typing decimal 
  42. numbers. Each feature is described briefly in the table below. 
  43. Detailed instructions follow the table.
  44.  
  45. BUTTON    ACTION
  46. ------    ------------------------------------------------------------
  47. About     Displays information about SetupPrn and MG Software.
  48. Append... Converts characters to decimal and appends the result to the
  49.           to the DECIMAL PRINTER COMMAND text box.
  50. Colors    Changes the foreground and background colors.
  51. Clear     Clears FUNCTIONs or DECIMAL commands.
  52. Execute   Sends DECIMAL command to printer.
  53. Help      Displays this text.
  54. Load      Loads printer FUNCTIONs from disk.
  55. Quit      Ends SetupPrn.exe.
  56. Save      Writes the decimal command and an identifier to disk.
  57. Test Page Prints a test page.
  58.  
  59.  
  60. PRINTER FUNCTIONS LIST BOX
  61. --------------------------
  62. The list box on the left side of the screen holds printer functions 
  63. like Bold, Italic, Underline and Form Feed. On program startup it 
  64. includes four functions common to almost all printers: Carriage 
  65. Return, Escape, Form Feed and Line Feed.
  66.  
  67. To select a printer function from the list box place the mouse
  68. pointer over the desired printer function and click once. The matching 
  69. decimal command will be added to the printer commands list box.
  70.  
  71. If you are not using a mouse TAB to the list box, move the highlight
  72. to the desired function and press ENTER.
  73.  
  74. The LOAD button (below the list box) loads previously saved commands
  75. into the list box. One printer command file HP.CMD is included in the
  76. shareware distribution. HP.CMD is loaded automatically for windows 
  77. users. 
  78.  
  79. You can build your own command file by pressing the save button. 
  80.  
  81. You will be sent a list of available free printer command files when 
  82. you register.
  83.  
  84. Details on building printer command files are provided below.
  85.  
  86. The CLEAR button (below the printer functions list box) clears the 
  87. list and returns it to its original state with four generic commands.
  88.  
  89.  
  90. PRINTER COMMAND TEXT BOX
  91. ------------------------
  92. The printer command text box holds the current printer command 
  93. represented as a set of decimal numbers separated by spaces.
  94.  
  95. You can type digits into this text box and you can edit any
  96. digits in the text box. Editing keys include backspace, home, end,
  97. and the four cursor keys.  Highlighting keys are available for 
  98. deleting or replacing a group of digits. Highlighting keys are 
  99. shifted cursor keys. The mouse is also useful for highlighting 
  100. and moving the insertion point.
  101.  
  102. The CLEAR button (below the printer command text box) deletes all
  103. text from the text box. 
  104.  
  105. The APPEND CHARACTERS button allows you to enter a set of printable
  106. ASCII characters which are then converted to decimal and appended to
  107. whatever is in the text box.
  108.  
  109. The SAVE button saves the printer command currently in the printer
  110. command text box to the file you select. If you do not select a
  111. file (e.g. press cancel), you will be asked if you want to create
  112. a new printer commands file.
  113.  
  114. The EXECUTE button converts the contents of the printer command
  115. text box to ASCII and sends the ASCII string to the printer.
  116. It also clears the printer command text box, so it is wise to save
  117. your printer command before executing it.
  118.  
  119.  
  120. OTHER BUTTONS
  121. -------------
  122. The ABOUT button gives a brief description of the program and its
  123. origin at MG Software.
  124.  
  125. The COLORS button helps you change the foreground and background 
  126. screen colors.
  127.  
  128. The HELP button gives a brief description the program and
  129. each button.
  130.  
  131. The TEST PAGE button prints lines from the document in 
  132. setupprn.txt as a test of your current printer settings.
  133.  
  134. The QUIT button exits the program.
  135.  
  136.  
  137. CREATING A PRINTER COMMAND FILE
  138. -------------------------------
  139. SetupPRN will append to an existing printer command file. The 
  140. format of the printer command file is:
  141.  
  142. <printer name>
  143. <command name>|<decimal command string>
  144. <command name>|<decimal command string>
  145. <command name>|<decimal command string>
  146.       .
  147.       .
  148.       .
  149.  
  150. If you press cancel on the save dialog box you will be asked
  151. if you want SetupPRN to create a new command file for you.
  152.  
  153. You may also use any text editor to make your own command file
  154. without SetupPRN. We advise you to look at HP.CMD first.
  155.  
  156.  
  157. COMMAND LINE ARGUMENTS
  158. ----------------------
  159. Two command line arguments are supported: (1) default printer
  160. file name and (2) colors.
  161.  
  162. These arguments allow you to customize SetupPRN so that it always 
  163. loads your command set and colors. 
  164.  
  165. USAGE: SetupPRN [<command file name> [<foreground> <background>]]
  166.  
  167. Command file name is the complete path and file name of the
  168. command file you want to load at startup.
  169.  
  170. Foreground and background colors are numbers separated by spaces.
  171. The easiest way to derive good color numbers is to press the COLORS
  172. button on SetupPRN. After selecting colors you will be told their
  173. numerical equivalent.
  174.  
  175.  
  176. CAVEATS
  177. -------
  178. The DOS version of SetupPRN works like a Windows program. If 
  179. you are familiar with Windows you will know how to use it when
  180. you see it.
  181.  
  182. Any digits between 0 and 255 which you type into the printer 
  183. command text box will be converted to ASCII and sent to the 
  184. printer. SetupPRN does not validate printer commands. If you 
  185. make an error it will be sent to the printer! Although you are
  186. given two opportunities to abort before execution. 
  187.  
  188. You may want to send a reset command to clear all settings and 
  189. try again when you send an incorrect string to the printer.
  190.  
  191. SetupPRN will always send its command string to the printer. 
  192.  
  193. Some programs like to reset the printer before printing a report,
  194. in this case any settings made with SetupPRN will be lost.
  195.  
  196. Printers are usually reset when power is interrupted. So if you
  197. turn your printer off and then back on, you will loose any setup
  198. you did with SetupPRN. So, save your settings and rerun SetupPRN
  199. each time you power up your printer.
  200.  
  201. Sometimes you may configure your printer with SetupPRN and then
  202. decide you want a completely different configuration. In such cases
  203. execute a reset command using SetupPRN followed by the new
  204. configuration.
  205.  
  206. Your configuration command my be several thousand digits and spaces
  207. long, so you may want to save difficult configurations as ONE 
  208. printer function.
  209.  
  210. MG Software does have a native Windows version of SetupPRN. It
  211. is available to registered users. The DOS version is the most
  212. useful version even to Windows users because: most Windows programs 
  213. which print do so using Print Manager. Most Print Manager printer 
  214. dri